home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 126-150 / scopedisk139 / frqlibrary / fr_bypass.doc < prev    next >
Text File  |  1995-03-19  |  4KB  |  117 lines
  1.  ---------------------
  2. |   FR Bypass 2.20    |
  3. |                     |
  4. | By: Khalid Aldoseri |
  5.  ---------------------
  6.  
  7. FR_Bypass allows the file requester in 'kd_freq.library' to be used with
  8. many programs that use other file requesters in libraries.
  9.  
  10. FR_Bypass will replace the file requesters in the following libraries:
  11.  
  12.   arp.library  The ARP file requester.
  13.   req.library  The file requester that comes with CED Pro 2.
  14.   asl.library  The standard file requester in AmigaDOS 2.0 and above.
  15.  
  16. Once the bypass is installed, every time a program calls any of the above
  17. file requesters, mine will come up instead!
  18.  
  19.  
  20. Installation:
  21. -------------
  22.  
  23. Copy FR_Bypass to your C: directory, and add it to your startup-sequence.
  24.  
  25. A window will come up informing you of the success of its installation.
  26. If it says 'Installation failed' then 'kd_freq.library' wasn't in the
  27. LIBS: directory.  Otherwise it will report the libraries found and bypassed.
  28. This can be something like this:
  29.  
  30.   'Installed: ARP REQ ASL Injector'
  31.  
  32. It will not allow you to run multiple copies of itself. You can quit it at
  33. any time by hitting 'right shift-right alt-q'.
  34.  
  35.  
  36. Required files:
  37. ---------------
  38.  
  39.  File name              Optional?   Version
  40.  --------------------   ---------   ------------
  41.  LIBS:kd_freq.library   Mandatory   2.0 or above
  42.  LIBS:arp.library       Optional    Any version
  43.  LIBS:asl.library       Optional    Any version
  44.  LIBS:req.library       Optional    Any version
  45.  
  46.  
  47. Programmer's Note:
  48. ------------------
  49.  
  50. FR_Bypass allows you to code for a standard file requester, like the
  51. asl.library requester, and still allow the user access to a high-powered
  52. file requester if he/she wants one.
  53.  
  54. You do not have to worry about my library at all.  All you need to do
  55. is to code as usual for one of the above libraries and FR_Bypass will
  56. handle the differences in calling procedures between that FR and my FR.
  57.  
  58. e.g.  In the case or ARP, it will trap the normal ARP FR call, read the
  59. ARP FileRequester structure, set the right calling procedure for my FR,
  60. call my FR, return from it, and set the right results in ARP format,
  61. and return the call to your program.  Your program will not know the
  62. difference.  Of course, using this technique has one disadvantage:
  63. You cannot use some special features of my FR, like extended select.
  64.  
  65.  
  66. Limitations:
  67. ------------
  68.  
  69. If the bypass code cannot handle a specific situation, e.g. if the
  70. req.library call is used to bring up a font requester, Bypass will
  71. call the original file requester since my f-r cannot handle this
  72. request reasonably.
  73.  
  74.  
  75. File Injector:
  76. --------------
  77.  
  78. This uses my FR to allow you to select a directory/file at any time and
  79. 'inject' its name into the keyboard stream.
  80.  
  81. To invoke the FR hit the 'right shift-right alt-r' key and the FR will show
  82. up on the front screen.  You then select a file from the requester and click
  83. on OK.
  84.  
  85. After that, you can, at any time, hit the 'right shift-right alt-s' key and
  86. Inject will feed the directory/filename into the keyboard stream.  You can
  87. also feed only the directory name by using the 'right shift-right alt-d' key
  88. or the filename alone by using the 'right shift-right alt-f' key.
  89.  
  90.  
  91. Summary of functions:  (all keys are with right shift-right alt combo)
  92.  
  93. Key   Action
  94. ---   --------------------------
  95.  r    Call up file requester.
  96.  s    Inject directory+filename.
  97.  d    Inject directory.
  98.  f    Inject filename.
  99.  q    Quit (unload) program.
  100.  
  101.  
  102.  
  103.  ----------------------------------
  104. | Copyright 1990  Khalid Aldoseri. |
  105. |          13 July 1990.           |
  106.  ----------------------------------
  107.  
  108. CygnusEd Professional & CED are Copyright 1987,1988,1989 CygnusSoft Software.
  109.  
  110. ARP is Copyright 1987,1988,1989 by ARP Authors.
  111.  
  112. Req.library was written by Colin Fox (of Pyramyd Designs) and Bruce Dawson
  113. (of CygnusSoft Software).
  114.  
  115. asl.library comes with AmigaDOS version 2.0 and above.
  116. I believe this is Copyright CBM.
  117.